docs: capture required-gate CI pattern (conventions + wiki + STATE)#219
Merged
Conversation
Documents the skip-shim convention shipped in #216 so it can't be silently regressed, and records the work in machine-readable state. - docs/AI-CONVENTIONS.adoc: new "CI / Required Status Checks" section; also fixes a stale Banned-Languages row (TypeScript -> AffineScript, not ReScript — ReScript retired as the destination 2026-04-30). - .claude/CLAUDE.md: new "CI / Required Status Checks" section. - docs/wikis/CI-and-Required-Checks.adoc: new developer wiki page (problem, fix, copy-paste template, do/don't, diagnostic); linked from Home.adoc. - .machine_readable/6a2/STATE.a2ml: 2026-06-13 session entry (#216/#213/#215 + follow-up issues #218/#46/#47/#48); last-updated bumped. - .machine_readable/6a2/PLAYBOOK.a2ml: [ci-required-gates] runbook section. - CONTRIBUTING.md: brief CI/required-checks note. No workflow or code changes. https://claude.ai/code/session_019tMcRS1Dm1nWjjYP4WvbJa
🔍 Hypatia Security ScanFindings: 263 issues detected
View findings[
{
"reason": "Stale AI session file -- delete",
"type": "stale",
"file": "GEMINI.md",
"action": "delete",
"rule_module": "root_hygiene",
"severity": "medium"
},
{
"reason": "Issue in abi-drift.yml",
"type": "missing_timeout_minutes",
"file": "abi-drift.yml",
"action": "flag",
"rule_module": "workflow_audit",
"severity": "medium"
},
{
"reason": "Issue in codeql.yml",
"type": "missing_timeout_minutes",
"file": "codeql.yml",
"action": "flag",
"rule_module": "workflow_audit",
"severity": "medium"
},
{
"reason": "Issue in container-publish.yml",
"type": "missing_timeout_minutes",
"file": "container-publish.yml",
"action": "flag",
"rule_module": "workflow_audit",
"severity": "medium"
},
{
"reason": "Issue in dogfood-gate.yml",
"type": "missing_timeout_minutes",
"file": "dogfood-gate.yml",
"action": "flag",
"rule_module": "workflow_audit",
"severity": "medium"
},
{
"reason": "Issue in dogfood-gate.yml",
"type": "missing_timeout_minutes",
"file": "dogfood-gate.yml",
"action": "flag",
"rule_module": "workflow_audit",
"severity": "medium"
},
{
"reason": "Issue in dogfood-gate.yml",
"type": "missing_timeout_minutes",
"file": "dogfood-gate.yml",
"action": "flag",
"rule_module": "workflow_audit",
"severity": "medium"
},
{
"reason": "Issue in dogfood-gate.yml",
"type": "missing_timeout_minutes",
"file": "dogfood-gate.yml",
"action": "flag",
"rule_module": "workflow_audit",
"severity": "medium"
},
{
"reason": "Issue in dogfood-gate.yml",
"type": "missing_timeout_minutes",
"file": "dogfood-gate.yml",
"action": "flag",
"rule_module": "workflow_audit",
"severity": "medium"
},
{
"reason": "Issue in dogfood-gate.yml",
"type": "missing_timeout_minutes",
"file": "dogfood-gate.yml",
"action": "flag",
"rule_module": "workflow_audit",
"severity": "medium"
}
]Powered by Hypatia Neurosymbolic CI/CD Intelligence |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documentation-only follow-up to #216 — captures the required-gate "skip-shim" as a durable convention so it can't be silently regressed, and records the work in machine-readable state. No workflow or code changes.
What's added
docs/AI-CONVENTIONS.adoc— new "CI / Required Status Checks" section (the do/don't rule). Also fixes a stale Banned-Languages row:TypeScript → AffineScript(not ReScript — retired as the destination 2026-04-30, per CLAUDE.md)..claude/CLAUDE.md— matching "CI / Required Status Checks" section for AI agents.docs/wikis/CI-and-Required-Checks.adoc— new developer wiki page: the problem (path-filtered required check → permanent "Expected" → blocked PR), the fix, a copy-paste workflow template, a do/don't table, and the green-but-blocked diagnostic. Linked fromHome.adoc..machine_readable/6a2/STATE.a2ml— 2026-06-13 session entry (ci: make path-filtered required gates always report (unblock stuck PRs) #216 + merged chore(deps): bump nixpkgs from8c3cedeto8c91a71#213/feat(scripts): extend §1.5 verb-canary coverage (Phase E) #215 + follow-ups Governance/Hypatia hygiene: stale GEMINI.md, unpinned action, workflow timeouts, shellcheck #218/docs(policy): add .claude/CLAUDE.md with TypeScript exemption table #46/ci(antipattern): allowlist legit TS bridge/adapter paths #47/ci(antipattern): broaden TS allowlist (cli, mod.ts, lsp-server, *vscode*, deno-*) #48);last-updatedbumped..machine_readable/6a2/PLAYBOOK.a2ml—[ci-required-gates]runbook section.CONTRIBUTING.md— brief pointer note.Both a2ml files verified to still parse as TOML. Draft for your review.
https://claude.ai/code/session_019tMcRS1Dm1nWjjYP4WvbJa
Generated by Claude Code